home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / wb / MagicEYE.lha / magiceye / MagicEYE.doc < prev    next >
Text File  |  1995-06-17  |  8KB  |  146 lines
  1.         __       __
  2.         )\\     /((  Version 37.1                            __
  3.        /  \\   /  \\         39.1  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / //    @ 1995 by    \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.          sMail:                     eMail:                 _______  ___ _____
  13.      Christian Krapp                                      / __//\ \/ /// __//
  14.      Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
  15.    D-86391 Stadtbergen                                  / //__   / /// //__
  16.      (GERMANY)                                          \___//  /_// \___//
  17.  
  18. --------------------------------------------------------------------------------
  19.  
  20. Copyright:
  21.   This program and all accompanying files (program-icon) are copyrighted 1995 by
  22. Christian 'cr8y' Krapp! You can  copy these files to your friends as long as the
  23. files are unchanged. It is not allowed to demand a fee higher as media costs and
  24. a (little)  copy-fee. In addition,  no one is allowed to put these  files onto a
  25. PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  26.  
  27. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  28.  
  29.   This  program isn't  Public Domain or  Shareware. It's is developt as Freeware
  30. Everyone, who use this program, should  send me an postcard or an eMail. (I want
  31. to know, how many (or much? ;^) ) Amiga-Fans use this program).
  32.  
  33. --------------------------------------------------------------------------------
  34.  
  35. What is it?
  36.   No: This is not again a program to render 3D pictures! Do you know the
  37. MagicWB-Stuff? (what a question ;^> ) And: I think you know these funny Eye-
  38. programs, which fellow the mouse-pointer! Ok. Than you know MagicEYE. It's an
  39. Eye-program for an MagicWB Workbench. 
  40.  
  41. --------------------------------------------------------------------------------
  42.  
  43. 4 reasons, why to use this program:
  44.  
  45. 1.) colorized eyes ;^)
  46. 2.) automatic window close, when prefs are changed
  47. 3.) you can configurate a lot
  48. 4.) patch to have an screen-drag MagicEYE-window
  49.  
  50. --------------------------------------------------------------------------------
  51.  
  52. What do you need?
  53.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  54. need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
  55. version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
  56. In  addition to the OS you  should run your Workbench with at least 8 colors and
  57. a quadratic resolution (e.g.  640×512).  As  color-palette you  should  use  the
  58. MagicWB-color-palette for  best  results.  Last  but not least you should use an
  59. 13 point  high font  for screen title.  This is necassery,  because MagicEYE has
  60. an fixed high of 13 points.
  61.  
  62. --------------------------------------------------------------------------------
  63.  
  64. Different program versions:
  65.   It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
  66. supported by MagicEYE. And so, I have produced two versions: One for AmigaOS 2.0
  67. (MagicEYE_37) and one for AmigaOS 3.0 (MagicEYE_39) and higher.
  68.  
  69. --------------------------------------------------------------------------------
  70.  
  71. How to install?
  72.   Nothing simpler than that: you copy only the right program-version of MagicEYE
  73. to your WBStartup-directory on you startvolume (disk, hd...). That's it :-]
  74.  
  75. --------------------------------------------------------------------------------
  76.  
  77. How to use?
  78.   You can run this program only from the Workbench (or the WBStartup directory).
  79. If you run it from a Shell, nothing happens! Also, all configuration is done in
  80. the icon ToolType:
  81.  
  82.   DONOTWAIT       : This has nothing  to do with  MagicEYE. It's only a flag for
  83.                     Workbench.
  84.   WIN_X           : Where  do you want to place  the MagicEYE-window?  Here  you
  85.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  86.                     WIN_Y=1
  87.   DELAY           : With this  value  you define how  long the  window disapear,
  88.                     when the preferences of the system are changed. The  default
  89.                     value is 5 seconds.
  90.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  91.                     0, so, other programs (which need the system-time) gets more
  92.                     system-time. The default value is 0 (program) or -5 (Icon).
  93.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  94.                     drag the  screen  with the  MagicEYE-window.  So there is no
  95.                     different on  the screen-title,  when  you want to drag down
  96.                     the screen (funny). Default is off!
  97.   SLEEPY          : This value  is needed, to define  how  often  the  Eyes  are
  98.                     closed.  Default is 40.  If you take a lower value, the Eyes
  99.                     are often  closed, an higher value means: close Eyes seldom.
  100.                     (Try different values!)
  101.   SLEEP_PERIOD    : This flag define the  time that  the program  wait,  till it
  102.                     close  the Eyes,  when the  mouse  isn't moved! Default: 50.
  103.                     (Try different values!)
  104.   FRESHUP_PER_SEC : This value  define,  how  often the  Eyes  are rendern  in a
  105.                     second. So, you have here the posibility to define, how much
  106.                     system-time is used from MagicEYE  (and of course  with  the
  107.                     PRIORITY).  An example: If you give as FRESHUP_PER_SEC an 1,
  108.                     the Eyes is renderd  once in a second. Default  is 50 (=> so
  109.                     MagicEYE renders the Eyes 50 times a second). The max. value
  110.                     for this flag  is 100 (Or have  you an screen-mode with more
  111.                     then 100Hz?). 
  112.  
  113.   So, that's it.  You know now all the features  of MagicEYE. Or...? You want to
  114. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  115. program?  Ok. I see... You want  know  this (very stupied :-|) feature: activate
  116. the MagicEYE-window (place the mouse-pointer over one eye and hit the left mouse
  117. button) and press the right mouse button. Now, the MagicEYE's should disappear.
  118.  
  119. --------------------------------------------------------------------------------
  120.  
  121. What can be made better?
  122.   * More funny things with the Eyes (roll the Eyes and so on).
  123.   * In the MagicEYE-verion for AmigaOS 3.0 and higher there is a function missed
  124.     which recolorize  the Eyes on  screens with  an  other  color-palette.  This
  125.     feature isn't implemented and I  only program it, when there are enough user
  126.     who want this feature.
  127.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  128.     which we doesn't want!
  129.  
  130. --------------------------------------------------------------------------------
  131.  
  132. For any reaseon (bug-report, ideas ...) try this:
  133.  
  134.                  sMail:           Christian Krapp
  135.                                   Hagenmähderstr. 9
  136.                                 D-86391 Stadtbergen
  137.                                   (GERMANY)
  138.                  eMail:           krabbe@informatik.fh-augsburg.de
  139.  
  140. --------------------------------------------------------------------------------
  141.  
  142. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  143.  
  144. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation)
  145. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  146.